home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 096 / useredit.arc / USEREDIT.DOC < prev   
Encoding:
Text File  |  1987-03-14  |  5.0 KB  |  114 lines
  1.  
  2.                                    USEREDIT
  3.                          An RBBS-PC user file editor
  4.                                   version 1.0
  5.  
  6.          This program is intended to aid RBBS SysOps in modifying their
  7.     user database.  I thought it would be useful when I saw how limited the
  8.     facilities were which came with RBBS-PC for this purpose.  This program
  9.     is also my first release to the user community at large, so please feel
  10.     free to comment, suggest changes, etc.
  11.  
  12.  
  13.     Using USEREDIT
  14.  
  15.          To start the program, simply enter USEREDIT at the DOS prompt.  It
  16.     will display a welcome banner, then search for the file USERS in the
  17.     default directory.  If it is not found, a prompt will be displayed,
  18.     requesting the correct name, path for the user file to be edited.  This
  19.     will continue until it finds the file specified.
  20.  
  21.          Once the USERS file is found, USEREDIT will copy and analyze it.
  22.     The copy is made because I am paraniod about messing with the original
  23.     file (I don't trust the machine, or the users completely).  The copying
  24.     process may take a while from a physical disk and it is suggested that
  25.     the data files be located on a RAM disk.  All of USEREDIT's files will
  26.     be co-located.  This means that you must have at least enough free
  27.     space on the disk for one more copy of your USERS file, preferably room
  28.     for two more copies.  The second copy is for an old backup, which is
  29.     not deleted until USEREDIT terminates.  That way, if you don't make any
  30.     changes, your backup file remains intact.
  31.  
  32.          The record usage report is simply my way of double checking that
  33.     the program read the data correctly.  After all, most SysOps know how
  34.     many records are in their USERS files and probably how many are active
  35.     also.  So this display is just a bit of safety for my piece of mind.
  36.  
  37.  
  38.     The Main Menu
  39.  
  40.          If you can call it that, this menu offers the wonderfully wide
  41.     selection of Edit, Quit, or Help.  Choosing Edit will allow you to
  42.     selectively scan through your USERS file, only actually editing the
  43.     records you need to change.  You may scan either Forward or Backward
  44.     through the file.  The direction may be changed by pressing the left or
  45.     right arrow keys when in scan mode.  Once you decide to edit a record,
  46.     press E, and the first field of the record will be highlighted.
  47.  
  48.               Editing Keys
  49.  
  50.               Key       Action
  51.             ════════════════════════════════════════════════════
  52.                        move highlight bar back one field
  53.  
  54.                        move highlight bar ahead one field
  55.  
  56.               ┘        move highlight bar ahead one field,
  57.                          except on the last field - enter record & end edit
  58.  
  59.               ═        move cursor back one character
  60.  
  61.               ═        move cursor ahead one character
  62.  
  63.               Ins       insert a space at the cursor
  64.  
  65.               Del       delete the character at the cursor
  66.  
  67.               Esc       erase entire field
  68.  
  69.             BackSpace   delete character to left of cursor
  70.  
  71.              Space      replace character to right of cursor with a space
  72.  
  73.  
  74.          Selecting Help from the main menu will give you a short, (two
  75.     page) display which contains as much information about the functioning
  76.     of USEREDIT which I could fit.  The displays given throughout operation
  77.     of USEREDIT should be sufficiently helpful, once you've read this file
  78.     at least once.
  79.  
  80.          Selecting Quit will first get you a quick question 'Are you
  81.     sure?'.  This is to prevent you from inadvertantly exiting from
  82.     USEREDIT.  (Even so, from anywhere, EXCEPT editing a field, three
  83.     escapes will terminate the program.)  While it is cleaning up after
  84.     itself, USEREDIT will leave at least one extra file behind, called
  85.     USERS.BAK.  This file will contain the copy of your USERS file before
  86.     USEREDIT was run.  If no changes were made to the file, USERS.BAK will
  87.     not be created.
  88.  
  89.  
  90.             ════════════════════════════════════════════════════
  91.  
  92.  
  93.          Planned enhancements include searching for a particular user by
  94.     name or number, better file handling, and editing routines which
  95.     understand dates and times better.  Suggestions for further improvement
  96.     are welcome.
  97.  
  98.  
  99.             ════════════════════════════════════════════════════
  100.  
  101.  
  102.     The program is written in Turbo Pascal, with many thanks to the people
  103.     who wrote BOOSTERS.  I am willing to get you a copy of the source
  104.     code, if you really want it.  All I ask is that you at least cover the
  105.     postage (Uncle Sam doesn't give his young airmen a whole lot of
  106.     spending money).  I can be contacted at the following address:
  107.  
  108.                         Steve Valliere
  109.                         PSC Box 7307
  110.                         Patrick AFB  FL
  111.                                 32925-5368
  112.  
  113.          or send me mail on CompuServe, acct. no.: 72330,631
  114.